Skip to content

docs: add architectural concepts for operating model#65

Merged
normenmueller merged 2 commits into
trunkfrom
docs/61-architectural-concepts
May 7, 2026
Merged

docs: add architectural concepts for operating model#65
normenmueller merged 2 commits into
trunkfrom
docs/61-architectural-concepts

Conversation

@normenmueller
Copy link
Copy Markdown
Owner

Story

closes #61 (S2: Architectural Concepts Documentation)
Parent Epic: #59

Changes

Adds four architectural concept sections to doc/arc/08_concepts.md:

Concept Key Content
Agent-Host Agnosticism Principle CCC declares what/how, never where. Strict separation: declaration vs. materialized artifacts.
Materialization Boundary Deterministic, stateless transformation. First step of spawn lifecycle.
Self-Validating Design Goal spawn(curate(ai4X's requirements)) ≡ ai4X's own agent team — explicitly aspirational.
Three-Layer Model Collaboration Topology (L1), Agent-Host Binding (L2), Team Declaration (L3).

An Operating Model overview section frames all four concepts as architectural substance for the three differentiating properties.

Review remediation

  • Added (Design Target) qualifier to CCC on first use (M-1)
  • Rewrote Three-Layer Model consequence with prescriptive must-constraints (M-2)

AC Coverage

AC Status
AC-6: Four concept sections
AC-7: Three layers named and described
AC-8: spawn(curate()) formula, marked aspirational
AC-9: No ADR section or ADR-numbered entries

Add four concept sections to 08_concepts.md:
- Agent-Host Agnosticism Principle
- Materialization Boundary
- Self-Validating Design Goal (aspirational, with spawn(curate()) formula)
- Three-Layer Model (Collaboration Topology, Binding, Team Declaration)

No ADR sections or ADR-numbered entries per AC-9.

closes #61
- Add Design Target qualifier to CCC on first use (M-1)
- Rewrite Three-Layer Model consequence with prescriptive must-
  constraints instead of permissive can-language (M-2)
@normenmueller normenmueller merged commit a0e9e6e into trunk May 7, 2026
1 check passed
@normenmueller normenmueller deleted the docs/61-architectural-concepts branch May 7, 2026 22:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

S2: Architectural Concepts Documentation

1 participant